home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / gnustuff / tos / gawk / gawk213s.zoo / gawk-src-2.13 / README < prev    next >
Encoding:
Text File  |  1991-06-06  |  4.7 KB  |  124 lines
  1. **** NOTE: The texinfo manual is being edited and will be restored
  2. **** to the distribution shortly after the release.    
  3.  
  4. README:
  5.  
  6. This is GNU Awk 2.13. It should be upwardly compatible with the
  7. System V Release 4 awk.  It is almost completely compliant with draft 11
  8. of POSIX 1003.2.
  9.  
  10. This release is essentially a bug fix and tuning release.
  11.  
  12. See the installation instructions, below.
  13.  
  14. Known problems are given in the PROBLEMS file.  Work to be done is
  15. described briefly in the FUTURES file.  Verified ports are listed in
  16. the PORTS file.  Please read the LIMITATIONS and ACKNOWLEDGMENT files.
  17.  
  18. The gawk.texinfo included in this release is out of date with respect to
  19. the code.  An updated manual will be released soon after the code.
  20. It can be changed into an info file (included) with
  21. makeinfo or with texinfo-format-buffer in emacs without changes.
  22.  
  23. The man page is up to date.
  24. If you do not have nroff or troff, you can use `awf' included in
  25. the test suite to format the manual page with only a few small problems.
  26.  
  27. Summary of Changes from 2.11.1
  28.  
  29. Configuration is via a config file which is used by the "mkconf" script
  30. to create Makefile and config.h.  Sample configuration files for various systems
  31. are included in the config directory.
  32.  
  33. Non-POSIX options are arguments to -W; all non-compliant options are
  34. deprecated.
  35.  
  36. New option "-W lint" to do extra checking.  The coverage
  37. will expand a bit in future releases.
  38.  
  39. Numeric to string conversion is done via the builtin variable CONVFMT
  40. rather than OFMT, in conformance with the POSIX draft standard.  It is
  41. initialized with the same value as OFMT, so the vast majority of programs
  42. should see no change in behaviour.
  43.  
  44. Awk program source no longer has any line length limits.
  45.  
  46. New builtin functions systime() and strftime() provided.
  47.  
  48. Error messages improved.
  49.  
  50. FIELDWIDTHS variable gives a space-separated list of numbers specifying the
  51. widths of input fields, to accomodate fixed-format input.
  52.  
  53. Numerous bug fixes and portability improvements.
  54.  
  55. Performance is about 50% better than 2.11.1, although the improvements
  56. are uneven.
  57.  
  58. The code has been extensively tested with test coverage monitored.
  59. A test suite is now included.  This will be expanded in future releases.
  60.   
  61. INSTALLATION:
  62.  
  63. The Makefile may need some tailoring.  The only changes necessary should
  64. be to change installation targets or to change compiler flags.
  65. The changes to make in the Makefile are commented and should be obvious.
  66.  
  67. All other changes should be made in a config file.  Samples for
  68. various systems are included in the config directory.  Starting with
  69. 2.11, our intent has been to make the code conform to standards (ANSI,
  70. POSIX, SVID, in that order) whenever possible, and to not penalize
  71. standard conforming systems.  We have included substitute versions of
  72. routines not universally available.  Simply add the appropriate define
  73. for the missing feature(s) on your system.
  74.  
  75. If you have neither bison nor yacc, use the awk.tab.c file here.  It was
  76. generated with bison, and should have no AT&T code in it.  (Note that
  77. modifying awk.y without bison or yacc will be difficult, at best.  You might
  78. want to get a copy of bison from the FSF too.)
  79.  
  80. If no config file is included for your system,  start by copying one
  81. for a similar system.  One way of determining the defines needed is to
  82. try to load gawk with nothing defined and see what routines are
  83. unresolved by the loader.  This should give you a good idea of how to
  84. proceed.  We would like to receive a copy of any new config files.
  85.  
  86. If you have an MS-DOS system, use the stuff in the pc directory.
  87. For an Atari theere is an atari directory and similarly one for VMS.
  88.  
  89. After successful compilation, do 'make test' to run a small test suite.
  90. There should be no output from the 'cmp' invocations.  If there is, please
  91. investigate and report the problem.  More extensive testing can be invoked
  92. with 'make bigtest'.  There are many interesting programs in the test suite!
  93.  
  94. PRINTING THE MANUAL
  95.  
  96. The 'support' directory contains texinfo.tex 2.40, which will be necessary
  97. for printing the manual, and the texindex.c program from the emacs distribution
  98. which is also necessary.  See the makefile for the steps needed to get a
  99. DVI file from the manual.
  100.  
  101. CAVEATS
  102.  
  103. The existence of a patchlevel.h file does *N*O*T* imply a commitment on
  104. our part to issue bug fixes or patches.  It is there in case we should
  105. decide to do so.
  106.  
  107. BUG REPORTS AND FIXES:
  108.  
  109. Please coordinate changes through David Trueman and/or Arnold Robbins.
  110.  
  111. David Trueman
  112. Department of Mathematics, Statistics and Computing Science,
  113. Dalhousie University, Halifax, Nova Scotia, Canada
  114.  
  115. UUCP        {uunet utai watmath}!dalcs!david
  116. INTERNET    david@cs.dal.ca
  117.  
  118. Arnold Robbins
  119. 1736 Reindeer Drive
  120. Atlanta, GA, 30329, USA
  121.  
  122. INTERNET:    arnold@skeeve.atl.ga.us
  123. UUCP:        { gatech, emory, emoryu1 }!skeeve!arnold
  124.